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Preface 


Intended Audience 

This manual is intended primarily for system programmers and application 
programmers. 


Document Structure 

This document consists of the following three sections: 

• Description—This section is in Part I. It provides a description of the 
National Character Set (NCS) Utility and detailed instructions on how to 
build NCS definition files. 

• Usage Summary—This section is in Part II. It outlines the following NCS 
information: 

- Invoking the utility 

- Exiting from the utility 

- Directing output 

- Restrictions or privileges required 

• Qualifiers—This section is in Part II. It describes the NCS qualifiers, 
including format, parameters, and examples. 


Associated Documents 

For related information about the NCS Utility, see the following documents: 

• VMS DCL Dictionary 

• Guide to VMS Programming Resources 

• VMS Sort/Merge Utility Manual 

• VMS Librarian Utility Manual 










Preface 


Conventions 


Convention 

Meaning 

m 

In examples, a key name (usually abbreviated) 
shown within a box indicates that you press 
a key on the keyboard; in text, a key name is 
not enclosed in a box. In this example, the key 
is the RETURN key. (Note that the RETURN 
key is not usually shown in syntax statements 
or in all examples; however, assume that you 
must press the RETURN key after entering a 
command or responding to a prompt.) 

CTRL/C 

A key combination, shown in uppercase with a 
slash separating two key names, indicates that 
you hold down the first key while you press the 
second key. For example, the key combination 
CTRL/C indicates that you hold down the key 
labeled CTRL while you press the key labeled C. 
In examples, a key combination is enclosed in a 
box. 

$ SHOW TIME 

In examples, system output (what the system 

05-JUN-1988 11:55:22 

displays) is shown in black. User input (what 
you enter) is shown in red. 

$ TYPE MYFILE.DAT 

In examples, a vertical series of periods, or 


ellipsis, means either that not all the data that 


the system would display in response to a 


command is shown or that not all the data a 
user would enter is shown. 

input-file, . . . 

In examples, a horizontal ellipsis indicates 
that additional parameters, values, or other 
information can be entered, that preceding 
items can be repeated one or more times, or 
that optional arguments in a statement have 
been omitted. 

[logical-name] 

Brackets indicate that the enclosed item is 
optional. (Brackets are not, however, optional 
in the syntax of a directory name in a file 
specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 

The term quotation marks is used to refer 

apostrophes 

to double quotation marks ("). The term 
apostrophe ( # ) is used to refer to a single 
quotation mark. 


X 











Part I—Introduction to the National Character Set 
(NCS) Utility 

Part I introduces you to the National Character Set (NCS) Utility and 
provides details about building NCS definition files. 












NCS Description 

In processing strings, two common functions are collating and conversion. 
Collating sequences provide a means of comparing strings for sorting 
purposes; conversion functions provide a means for deriving an altered 
form of an input string based on a conversion algorithm. 

The National Character Set (NCS) Utility provides a common facility for 
defining collating sequences and conversion functions, registering them as 
definition modules in an NCS library, and providing a means for making 
them locally accessible to application programmers and system programmers. 
See Appendix A for a listing of the definition modules that are included in 
the default NCS library. 

Typically, NCS collating sequences are selective subsets of the Multinational 
Character Set. NCS collating sequences find widespread use in international 
applications. For example, a Spanish collating sequence would resolve sorting 
weights for characters you might encounter when processing strings from the 
Spanish language. 

NCS permits you to build collating sequences unique to your particular 
programming situation. For example, if you want the character C to collate 
between the characters G and H, you can retrieve the particular collating 
sequence from a central library, make the appropriate modifications, and 
then store the modified collating sequence in a local library that is readily 
accessible to your application program. 

You can implement NCS from an application program using the program 
interface that includes 10 callable NCS routines. The callable routines permit 
you to access collating sequences and conversion functions stored as definition 
modules in an NCS library. You can also use the NCS routines to save the 
definitions in a local library for subsequent use by comparison and conversion 
routines called from the application program. For instructions on using the 
NCS routines, see the VMS Utility Routines Manual. 

This manual provides information about how to use NCS interactively, using 
the DIGITAL Command Language (DCL) interface for doing the following 
library operations: 

• Creating NCS libraries 

• Inserting definition modules in NCS libraries 

• Replacing definition modules in NCS libraries 

• Extracting definitions from NCS library modules 

• Deleting definition modules from NCS libraries 

• Other tasks associated with library operations, including listing the library 
contents, directing the output of the library, and logging library activities 

By default, DCL attempts to replace definition modules in the default NCS 
library with definitions from a specified source file. That is, if you specify no 
qualifiers, DCL assumes you want to replace definition modules in the default 
NCS library. If you specify no definition source file, DCL prompts you for 
one, as shown in the following example. 
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$ NCS 
.File: 

Any other library activity requires you to use one or more command 
qualifiers. You may designate any NCS library as the object of a command 
by assigning it the logical name NCS$LIBRARY. 

The rest of Part I provides instructions for building NCS definition files. 


How to Build an NCS Definition File 

The following subsections describe the language syntax you must use when 
building NCS collating sequence definitions and NCS conversion function 
definitions. You can use any standard text editor to build definition files. 

All definition files have the following characteristics: 

• Include one or more definitions. 

• Have no restriction on including a mix of collating sequence definitions 
and conversion function definitions in a single definition file. 

• Use the file type NCS. 

• Have comments delimited by an exclamation point (!). 

• Do not permit line continuation for comments. 


Naming NCS Definition Files 

Each definition file should begin with a name that describes its contents. 

For example, if you want to convert strings of multinational characters 
to lowercase, use a name like MULTI—TO—LOWER. You can name NCS 
definition files using up to 31 characters including the letters A through Z and 
« through z, the numbers 0 through 9, the dollar sign ($), and the underscore 
character (_). Note that spaces are not allowed and that you may use either 
uppercase or lowercase letters when formulating definition names. 


Structuring a Definition File 

Each definition file consists of the following elements, in this order: 

1 Definition name 

2 Equal sign ( = ) 

3 Definition expression 

4 Terminating semicolon (;) 

A definition file has the following format: 

definition_name = definition_expression; 
definition_name = definition_expression; 

definition_name = definition_expression 
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Example NCS-1 includes excerpts from a definition file that provides several 
EDT conversion functions. 

Example NCS-1 Typical Definition File 


i Define the EDT fallback conversion function, and UNEDT, its inverse. 

! Note that applying EDT and then UNEDT to a file may not result in the 
! original file, if, for example, the original file contains the string A 

! 

EDT_VT2xx = CF( 

CF = .IDENTITY, 

MODIFICATIONS 3 ( 

•/.X00 = "‘0", 

•/.X01 = "‘A", 

*/,X02 = "“B" , 


%XF0 = "<XF0>", 

*/.XFE = "<XFE>" , 

%XFF = "<XFF>")); 

UNEDT.VT2xx = INVERSE(EDT.VT2xx); 

! 

!start of definition EDT (a modified version of EDT_VT2xx) 
! 

EDT = CF( 

CF = EDT_VT2xx, 

MODIFICATIONS 3 ( 

%XA0 3 "<XA0>", 

%XA1 3 "<!!>", 

’/,XA2 3 "<C/>", 


%XFB 3 "<u*>", 

%XFC 3 "<u"">", 

*/,XFD 3 "<y"">")) ; 

I 

(Definition UNEDT (the complement of EDT) 

j 

UNEDT 3 INVERSE(EDT); 

j 

!The next 2 definitions - EDT1 and UNEDT1 - are structured such that . 

! UNEDT1(EDT1(string)) 

!... always gives the original string. 

j 

EDT1 = CF(CF=EDT,M0DI=( 

n ~ h — h ~ = n 

»<» = »<=»)); 

I 

!The complement of EDT1 

I 

UNEDT 1 = INVERSE (EDT1) ;______ 

Section 1.3 describes the notation used in NCS definitions. The expressions 
and keyword clauses that comprise NCS definitions are described in Sections 
1.5 and 1.6. 
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1.3 Notation Guidelines 


Table NCS-1 lists the language notation to be used in NCS definition files. 


Table NCS-1 

NCS Language Notation 

Notation 

Meaning 

! 

Starts a comment 

0 

Establishes entity grouping for ordering operations. 


In a collating sequence clause, reads literally left term 
collates as right term; in a conversion function clause, 
reads literally term converts to right term 

> 

In a collating sequence clause, reads literally left term 
collates just greater than right term 

< 

In a collating sequence clause, reads literally left term 
collates just less than right term 

+ 

Within a clause, indicates string concatenation; in an 
expression, indicates an appended collating sequence 

• 

Indicates a series of expressions comprising one definition 

— 

Indicates a range of string data 

mi 

Encloses literal string data 

% 

Indicates the start of a string numeric value 

D 

Indicates a decimal numeric value 

H 

Indicates a hexadecimal numeric value 

0 

Indicates an octal numeric value 

i 

Delimits expressions and clauses 


Terminates an NCS definition 


You can construct a definition in free form using indentation and one item 
per line to improve readability. For example, the following definition is 
functionally acceptable, but is difficult to read: 


FRENCH_NRC_TO_MULTI = 

CF(CF=_IDENTITY,MODIFICATIONS™ 

("#"="£», ngfi = „£„, t , £ o .. 

"\ " = "£» f »»] ft | II _!»£», 

tt | ti — n^ti ' ft ] ff—ft^tf^ t»A a t, = „~ ff 

" A e"="e", " A o"= ,, 6", " A u »'=»fQf» 

"~a"="a", "~e"="e", ) 

ZK-6571-HC 

Using indentation and one item per line makes the same definition much 
easier to read: 
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FRENCH_NRC_TO_MULTI = CF( 

CF = _IDENTITY, 

MODIFICATIONS*( 

•i^ti gg n£it f 

"@" = "a", 

" [ " = " ° " , 

M\»» = " 9 ", 

»{» = "e", 

»» | »» = "u", 

"}» = "e", 

?! a^»» = ** a”, 

i» a e ii _ ’’a” / 

iiAq'I = "6", 

II A U II = 

"~a" = "a", 

"~ e " = »e», 

»l^ 0 M = "6") ) 

ZK-6572-HC 

When you format a file for readability, do not omit the required punctuation. 

Strings can be represented literally and numerically. If you use literal strings 
(as in the preceding example), you must enclose them in double quotation 
marks ("). 

If you choose to represent strings numerically, you can use either decimal, 
hexadecimal, or octal numbers. You must precede numeric values by a 
percent sign (%) and the appropriate radix symbol (D for decimal, X for 
hexadecimal, O for octal). Note that you can use only digits that represent a 
single character, and that the radix notation must be less than decimal 256, 
regardless of the numbering system you use. 

For example, the following statement from the previous example may be 
coded using a literal string or a numeric string: 

n~ e .i = He", ! literal string 

n~ e ii = »'%XEB n , ! "e” represented as hexadecimal number 

Numeric strings are particularly appropriate when processing characters from 
either the ASCII subset or the EBCDIC subset. 


1.4 Built-In Collating Sequences and Conversion Functions 

NCS includes two built-in definitions: the -NATIVE collating sequence 
and the -IDENTITY conversion function. You use the built-in definitions 
as a basis for creating other collating sequences and conversion functions. 
The built-in definitions are distinguished by the leading underscore in their 
names. Note that the built-in collating sequence and the built-in conversion 
function are not stored in the NCS library and cannot be modified. 

The -NATIVE collating sequence collates strings by ascending numeric value. 
For collating purposes, the null character (NUL) has the lowest value of all 
characters in the set. 

Following is an example of how you might use the —NATIVE collating 
sequence to specify a collating sequence: 

MY_CS = .NATIVE * (MULTI.TO.NODIACRITICALS * MULTI.TO.LOWER) 
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The —IDENTITY conversion function reproduces each input string character 
as an output string character, except for characters that are explicitly being 
modified. Following is an example of using the —IDENTITY conversion 
function: 

MY_CF = CF(CF = .IDENTITY. 

MODIFICATIONS^ "ME" = "YOU" 

"NOW" = "THEN" 

"BLUE" = "RED") 

Using this conversion function, the input string Tell me now the sky is blue is 
converted to the output string Tell you then the sky is red. 


1.5 Definition Expressions 

You can define collating sequences and conversion functions using various 
types of expressions. Section 1.5.1 describes the types of expressions used 
in formulating collating sequences. Section 1.5.3 describes the types of 
expressions used to define conversion functions. 

Note that vertical ellipses are used in some examples to indicate omitted code. 


1.5.1 

Collating Sequence Expressions 

You can define collating sequences using any combination of the following 
types of expression: 

• The name of an existing collating sequence 

• A sequential series of collating sequences 

• An expression that includes appended collating sequences 

• A modified collating sequence 

• A reversed collating sequence 

• A reordered collating sequence 

1.5.1.1 

Definition Name 

You can create a new collating sequence by equating it to the name of an 
existing collating sequence, using the following format: 

new_collating_sequence = name_of_existing_collating_sequence, 

Following is an example of this type of expression: 

MY.COLLATING.SEQUENCE = MULTINATIONAL.!, 

1.5.1.2 

Sequential Series of Expressions 

You can create a new collating sequence from a sequential series of 
expressions, including one or more conversion functions and an existing 
collating sequence, in the following format: 

new_ collating-sequence 

= collating-sequence * conversion_function_1 ♦ conversion function 7 

NCS processes the conversion functions first, going from right to left, and 
then applies the collating sequence. All processes are completed within a 
single pass. 
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MY_COLLATING_SEQUENCE = 

1.5.1.3 

new_collating_sequence 

new_collating_sequence 

MY.COLLATING.SEQUENCE = CS(CS 

1.5.1.4 


Following is an example of using a sequential series of expressions to create a 
collating sequence: 

CS(CS = .NATIVE * MULTI.TO.NODIACRITICALS * MULTI.TO.UPPER). 

The conversion functions convert uppercase letters to lowercase letters and 
strip the diacritical marks. The result is then combined with the -NATIVE 
collating sequence to derive a collating sequence that behaves as though the 
input strings have been converted and then compared by their numeric value. 

Expression with Appended Colleting Sequences 

You can create a collating sequence using an existing collating sequence and 
up to two appended collating sequences, in the following format: 

= collating_sequence_ 1 + collating—sequence—2 + collating—sequence—3, 

NCS processes the leftmost collating sequence in the first pass, and proceeds 
to process each of the remaining collating sequences going from left to right, 
using an individual pass for each. 

You can include conversion functions with each of the collating sequences 
using the asterisk (*) operator, in the following format: 

= collating—sequence—1 * conversion—a ♦ conversion—b + ... + ..., 

Although there is no limitation on the number of conversion functions 
you can use with each collating sequence, you should try to minimize the 
complexity of the expression by limiting the number of conversion functions. 
In a complex expression having several collating sequences with associated 
conversion functions, NCS applies conversion functions only to the related 
collating sequence. When NCS detects a distinction between the two strings 
being compared, the comparison function terminates. 

Following is an example of creating a collating sequence using an existing 
collating sequence with an appended collating sequence: 

= MULTINATIONAL.! + MULTINATI0NAL.2 * UPCASE « NODIACRITICALS) , 


Modified Collating Sequence 

You can create a collating sequence from a modified collating sequence using 
keyword clauses, in the following format: 

new_collating—sequence = CS(keyword_clause,keyword_clause, ...), 

The expression begins with a definition identifier (CS) followed by several 
keyword clauses enclosed in parentheses and separated by commas. The first 
keyword clause identifies the collating sequence that serves as a basis for the 
new collating sequence, and the second keyword clause lists the appropriate 
modifications. 

Following is an example of an expression that uses keyword clauses to create 
a new collating sequence by modifying an existing collating sequence. Each 
uppercase character gets the same collating weight as the associated lowercase 
character. 


MY.COLLATING.SEQUENCE = 

CF(CF = .IDENTITY, 
MODIFICATIONS^ 

•/.X41-*/.X5A = */.X61- , /.X7A, 
•/.XC0-7.XCF = •/.XEO-'/.XEF, 
*/,XDl-'/,XDD = ’/.XF1-7.XFD)); 


! Base collating sequence 

! Modifications 
! to the base 
! collating sequence 
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1.5.1.5 Reversed Collating Sequence 

You can create a new collating sequence by specifying the reverse order of an 
existing collating sequence, using the following format: 

new_collating_sequence = REVERSE(existing_collating_sequence) 

Using this form of expression, you might create a collating sequence where 
the letter C would collate greater than B, and the letter B would collate greater 
than A. 

Here is an example of using a reverse order collating sequence expression: 
MY_C0LLATING_SEQUENCE = REVERSE(.NATIVE), 

Using this expression, you could give collating weight precedence to 
lowercase characters over uppercase characters. 


1.5.1.6 Reordered Collating Sequence 

You can create a new collating sequence by reordering an existing expression 
through the use of parentheses. 

In the following example, NCS applies the conversion—function and compares 
the input strings using collating—sequence—b as a comparison basis in the 
first pass. If the strings do not compare, NCS compares the strings using 
collating—sequence—a as a basis during a second pass. 

old_collating_sequence ~ collating_sequence_a + collating_sequence_b * conversion—function. 

If you want to do the comparisons in a single pass using the sum of the 
collating sequences, reorder the operation using parentheses, as shown in the 
following example: 

new_collating_sequence = (collating_sequence_a + collating_sequence_b) * conversion_function. 


1.5.2 Collating Strings with Pad Characters 

In some instances, you may need to collate strings padded with one or more 
pad characters. Typically, a string may be padded with the ASCII SPACE 
character, but the pad character can be defined as any character. In order to 
avoid ambiguity when collating padded character strings, specify the collating 
value of the pad character in your collating sequence definition. For example, 
if you want to specify the collating weight of a pad character in a collating 
sequence, you might use the following statement: 

NATIVE.SPACEPAD = CS(CS=_NATIVE, MOD = ("" = */,X20)); 

This states that the shorter string should be treated as if it were padded with 
spaces for collating purposes. For example, the string ABC <SP> <SP> 
would have the same collating weight as the string ABC. 
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1.5.3 Conversion Function Expressions 

You can define conversion functions using any combination of the following 
types of expression: 

• The name of an existing conversion function 

• A sequential series of conversions 

• A modified conversion function 

• An inverted conversion function 

• A reordered conversion function 


1.5.3.1 Definition Name 

You can create a new conversion function from an existing conversion 
function by equating the new function to the name of the existing function, 
using the following format: 

new_conversion_function = name—of—existing—conversion—function, 

Following is an example of this type of expression: 

MY.CONVERSION = MULTI_T0_L0WER; 

1.5.3.2 Sequential Series of Conversions 

You can create a new conversion function by expressing it as the result of a 
sequential series of conversions, using the following format: 

new_conversion—function = conversion _1 • conversion _2 * conversion _3; 

NCS applies a sequential series of conversions in a single pass beginning 
with the rightmost conversion and continuing right to left. In the preceding 
format, conversion-3 is applied before conversion-2, and conversion-2 before 
conversion—1. 

Following is an example of a conversion function derived through a sequential 
series of conversions: 

MY_C0NVERSI0N = MCS.NODIACRITICALS * MCS.LOWER; 

1.5.3.3 Modified Conversion Function 

You can create a conversion function from another conversion function 
appropriately modified through the use of keyword clauses, in the following 
format: 

new_con version —function = CF(key word—clause,key word-clause, ...) 

The expression begins with a definition identifier (CF) followed by several 
keyword clauses enclosed in parentheses and separated by commas. The first 
keyword clause identifies the conversion function that serves as the basis for 
the new conversion function. The second keyword clause lists the appropriate 
modifications. 

Following is an example of an expression that uses keyword clauses to create 
a new conversion function: 

EDT1 = CF(CF=EDT,MODIFICATIONS 3 ( 

II ~ II — II * — II 
••<»• = «<=»)); 

In this example, the new conversion function (EDT1) is a modified 
representation of an existing conversion function (EDT). 
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1.5.3.4 Inverted Conversion Function 

You can create a new conversion function by logically inverting an existing 
conversion function, using the following format: 

new_conversion_function = INVERSE(CF_expression) 

Typically, you use inversion when you want to restore a converted string to 
its original form. For example, assume you have the following conversion 
function: 

EDT1 = CF( 

CF = .IDENTITY, MODI = ( 


•/.X01 = "~A" 
*/.X02 = "~B" 
‘/.X03 = "~C" 
51X04 = "*D" 
*/.X05 = "~E" 
55X06 = "*F" 
55X07 = "*G" 


= 55X00)); 

Now assume you want to convert the output string back to the original input 
string. To do this, you can use the following conversion function: 

UNEDTl = INVERSE(EDTl) 


1.5.3.5 Reordered Conversion Function 

You can effectively reorder conversion functions using parentheses. For 
example, the following format results in a two-pass comparison where 
collating—sequence—a is used as the basis for comparing the input strings 
during the first pass: 

my_cs = collating_sequence_a + collating_sequence_b * conversion_c * conversion_d. 

If the strings do not compare, conversion—d and conversion—c are applied to 
the input strings and then the strings are compared on the second pass based 
on collating—sequence—b. 

If you want a one-pass comparison that converts input strings and then 
compares them using the composite effects of collating—sequence—a and 
collating^sequence—b, add parentheses, as follows: 

my_cs = (collating_sequence_a + collating_sequence_b) * conversion _c * conversion _d. 
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1.6 Keyword Clauses 

Keyword clauses are the basic elements of a collating sequence definition. 
They are used to establish the basis for each collating sequence, to explicitly 
define modifications where applicable, and to optionally assign a version 
number to the collating sequence. 

As described previously, a definition expression can take the form of a 
definition identifier (CS or CF) followed by a set of one or more keyword 
clauses enclosed in parentheses and separated by commas, as follows: 

new_expression = CS(keyword_clause,keyword-clause, ...) 

All keyword clauses begin with a keyword followed by the equal sign and a 
value: 

keyword = value 

The value varies with the keyword, as shown in the next two sections. 

Note that you can abbreviate any keyword as long as the abbreviated form is 
not ambiguous. 

1.6.1 Collating Sequence Keyword Clauses 

There are four types of keyword clauses you can use to build a collating 
sequence expression: 

• CS 

• SEQUENCE 

• IDENT 

• MODIFICATIONS 

Each of these is described in the following subsections. 


1.6.1.1 CS Keyword Clause 

The CS keyword clause equates the keyword CS to a collating sequence 
expression that can take any one of the forms described in Section 1.5. The 
CS keyword clause typically establishes the collating basis for a collating 
sequence unless you use the SEQUENCE keyword clause. The CS keyword 
clause uses the following format: 

CS = CS—expression 

The following example illustrates the use of the CS keyword clause: 

MULTINATIONAL = CS( ! Define temporary for second pass. 

IDENT = "VI.0", 

CS - .NATIVE * MULTI.TOJJPPER. 

MODIFICATIONS 3 ( 

*/,XC6 > "Z", ! AE diphthong 

*/,XD8 > */,XC6, ! 0 with slash 


•/.XE0-*/.XEF = •/.XCO-V.XCF, 
'/,XFl-'/,XFD = •/.XDl-’/.XDD ) ) ; 
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1.6.1.2 SEQUENCE Keyword Clause 

The SEQUENCE keyword clause establishes the collating basis for a collating 
sequence when the CS keyword clause is not appropriate. Typically, you use 
this keyword clause when you do not have an existing collating sequence that 
is appropriate for your application and thus must fabricate one. 

The following example illustrates the use of the SEQUENCE keyword clause 
in fabricating the Dutch collating sequence: 

DUTCH = CS( 

SEQUENCE = (%XOO-"N", , "0", "A", »{»_».» %XD0 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS= ( ,, a ,, - ,, z ,, = M A"“"A" = "A", "Q" = "C" = »•£" 

"t"-"!" = "I", »£)"-"$•* = "0 H , = "U", = "Y" "a"-"a" = "A" 

"a" - M ae" = "<p M = n c n f = "E", " ^" — •• y. m = »*j»» "n" = "iJ" 

,, d ,, - ,, d n = "O", ,, 0 ,, = "0", = "U", "j" = »»y»» ,, (E" = »*oe m 

"fi" = "SS", "ce" = "(E", "" < %X00) ) 

+ CS ( SEQUENCE = (%XOO- ,, A ,, / "B ,, -’ , C ,, / "Q", ,, g ,f - ,, g" 

"F"-'T', "ft", "(E M , "O", "P M - M R" f 

^ M 0 n ””0 M ^ "z", "0 M , "A", 

%XD0, %XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= ("a"-"z" = "A"-"Z ,, / = "A"-"!", - »$"_»»¥")) 

+ REVERSE (__NAT IVE) ; 

ZK-6573-HC 

In this example, the first SEQUENCE keyword clause establishes-the collating 
sequence for the entire character set from %X00 through %XFF during the 
first pass. The associated MODIFICATIONS keyword clause effectively masks 
the lowercase characters and diacritical characters by equating each lowercase 
alphabetical character to its related uppercase alphabetical character, and 
by equating each diacritical character to its related nondiacritical, uppercase 
character. 

During'the second pass, the second SEQUENCE keyword clause establishes 
the collating sequence for the diacritical characters. The associated 
MODIFICATIONS keyword clause masks all lowercase characters, both 
diacritical and nondiacritical, by equating them to their related uppercase 
character. 


1.6.1.3 IDENT Keyword Clause 

The IDENT keyword clause is a special-purpose keyword clause that permits 
you to assign a version number to the collating sequence. The following 
example illustrates using the IDENT keyword to assign Version 1.0 to the 
Spanish collating sequence: 

SPANISH = CSC 

IDENT ■ "V1.0'\ 

CS = MULTINATIONAL. 


) ); 
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1.6.1.4 


MODIFICATIONS Keyword Clause 

The MODIFICATIONS keyword clause is typically used with the built-in 
collating sequence —NATIVE to derive a modified version of the collating 
sequence. 

In the following example, the new collating sequence 
(MULTINATIONAL _1) applies two conversion functions 
(MULTI—TO—NODIACRITICALS and MULTI_TO_UPPER) to the input 
strings. Then the collating sequence uses a modified version of the built-in 
collating sequence, —NATIVE, as the basis for comparing the strings. 

The first group of modifications assigns collating weights to the listed special 
characters. For example, the uppercase N tilde character (ft) is assigned the 
same collating weight as the alphabetic character (N). The second group of 
modifications gives each lowercase character the same collating weight as the 
associated uppercase character. 


MULTINATIONAL.i = CSC 

CS = .NATIVE * ( MULTI.TO.NODIACRITICALS * MULTI.TO.UPPER ), 
MODIFICATIONS^ 

l 


! Special characters 

i 


*/,XC6 > ”Z". 
%XD8 > */,XC6, 
*/,XC5 > V.XD8, 
7.XD1 > "N", 
*/.XDF = "SS". 
*/.XD7 = "OE". 


! AE diphthong 
! 0 with slash 
! A with ring 
! N tilde 
! S sharp 
! OE ligature 


! 

! Define lowercase to collate the same as uppercase 


•/.xeo-%xef = y.xco-y.xcF, 
%XFl-y.XFD = y,XDl-y.XDD ) ) ; 


1.6.2 Conversion Function Keyword Clauses 

There are three types of keyword clauses you can use to build a conversion 
function: 

• CF 

• IDENT 

• MODIFICATIONS 

Each of these is described in the following subsections. 

1.6.2.1 CF Keyword Clause 

The CF keyword clause equates the keyword CF to a conversion function 
expression, which can take any one of the forms described in Section 1.5. 
The general form for the CF keyword clause follows: 

CF = CF_expression 
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The following example illustrates the use of the CF keyword clause: 

MULTI.TO.NODIACRITICALS = CF( 

IDENT = "VI.0", 

CF - .IDENTITY, 

MODIFICATIONS^ 

/.XC0-/.XC5 = "A", ! Various forms of "A" assigned same weight 


'/,XF9-*/,XFC = "u", ! Various forms of "u" assigned same weight 

*/,XFD = "y" ) ) ; ! Y umlaut assigned weight of "y" 

See Section 1.4 for details on the use of the —IDENTITY built-in definition. 


1.6.2.2 IDENT Keyword Clause 

The IDENT keyword clause is a special-purpose keyword clause that permits 
you to assign a version number to the conversion function. The following 
example illustrates the use of the IDENT keyword clause to assign Version 
1.0 to a conversion function: 

MULTI.T0.L0WER = CF( 

IDENT * "VI.0", 

CF = .IDENTITY, 

MODIFICATIONS^ 

•/.X41-7.X5A = 7.X61-7.X7A, ! Characters A-Z 


7.XD1-7.XDD = •/.XFl-'/.XFD ) ) ; ! Various characters 


1.6.2.3 MODIFICATIONS Keyword Clause 

The MODIFICATIONS keyword clause is used in conjunction with another 
conversion function, typically the built-in conversion function -IDENTITY, to 
derive a modified version of the conversion function. The MODIFICATIONS 
keyword clause causes NCS to modify the specified conversion function, 
making changes in the specified order. 

The following example illustrates the use of the MODIFICATIONS keyword 
clause in a conversion function: 

MULTI.TO.UPPER = CF( 

IDENT = "V1.0", 

CF = INVERSE(MULTI.TO.LOWER). 

MODIFICATIONS-(XXDF - "SS". %XD7 - "0E");) 

In this example, the MODIFICATIONS keyword clause masks the lowercase 
sharp s (6) by equating it to the character pair SS and the uppercase OE 
ligature ((E) by equating it to the character pair OE. 


1.6.3 MODIFICATIONS Keyword Clause Syntax 

This section expands on the syntax requirements for developing 
MODIFICATIONS keyword clauses in an NCS expression. 

The conversion function MODIFICATIONS keyword clause uses the following 
format: 

left-string = right-string 
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NCS treats this as left string converts to right string. The following example 
illustrates the use of a MODIFICATIONS keyword clause in a conversion 
function: 


CF = .IDENTITY, 
MODIFICATIONS^ 

•/.X41-y.X5A = y.X61-y.X7A, 


In this example, NCS treats the MODIFICATIONS keyword clause as 
uppercase characters convert to lowercase characters, where the source string is 
a range of hexadecimal numbers representing uppercase alphabetic characters 
and the destination string is a range of hexadecimal numbers representing 
lowercase alphabetic characters. 

Note that the equal sign (=) is always the sign of operation for conversion 
function MODIFICATIONS keyword clauses. 

The various formats for the collating sequence MODIFICATIONS keyword 
clause are listed in Table NCS-2. 


Table NCS-2 Formats for Collating Sequence MODIFICATIONS 
Keyword Clauses 

Format Interpretation 


string - string 

left string 

range = string 

left range 

range = range 

left range 

string > string 

left string 

range > string 

left range 

range > range 

left range 

string < string 

left string 

range < string 

left range 

range < range 

left range 


collates as right string 
collates as right string 
collates as right range 
collates just greater than right string 
collates just greater than right string 
collates just greater than right range 
collates just less than right string 
collates just less than right string 
collates just less than right range 


You can specify a range of values in a keyword clause, using the following 
format: 

string 1 - string2 

The following example shows how to assign the left string the same collating 
value as the right string: 


CS = .NATIVE * ( MULTI.TO.NODIACRITICALS * MULTI.TO.UPPER ). 
MODIFICATIONS^ 

%XDF = "SS", 
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The MODIFICATIONS keyword clause in this example states that the 
hexadecimal value for S sharp (%XDF) has the same collating value as SS. 

The next example shows various source strings being assigned collating values 
that are relatively greater than, less than, and equal to the destination strings: 


MODIFICATIONS 3 ( 

*/.XDF > "S", ! S sharp 

*/,XD7 < "0", ! 0E ligature 

*/.XF7 3 */,XD7 ) ) ; ! oe ligature 


Here the hexadecimal value for S sharp collates just greater than the letter S, 
the hexadecimal value for the uppercase (E ligature collates just less than the 
letter O, and the hexadecimal value for the lowercase oe ligature collates equal 
to uppercase (E. 

You can also assign a range of strings the same collating value as a single 
string. For example, if you want to assign all of the lowercase alphabetical 
characters the same collating weight as a null character that typically has the 
lowest collating value in a set, you would state it as follows: 


CS = .NATIVE 

MODIFICATIONS 3 ( 

•/.X61-V.X7A = V.X00, 


In building a definition file, you can compose a definition that is not 
compatible with NCS because the function is not well defined or because of 
some restriction NCS may impose on the function. In analyzing a definition, 
use the NCS/EXTRACT command to retrieve the function (see Part II). The 
NCS/EXTRACT command restructures the definition in its most basic form. 
The resulting definition may not be as efficient as the original definition but it 
is generally more logically structured and easier to read. 
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NCS Usage Summary 



The NCS command invokes the National Character Set (NCS) Utility, which 
performs NCS library functions specified by NCS qualifiers. By default, 

NCS tries to replace the definition modules in the default NCS library with 
the definitions in the specified input file. All other NCS library functions 
require explicit command qualifiers. 

PARAMETER 

NCS [input-filespec] 

PARAMETER 

[input-filespec,...] 

Where applicable, specifies the name of one or more input files containing 
definitions that NCS is to use to perform the action specified by the command 
qualifier. By default, NCS attempts to replace modules in the default NCS 
library with definitions in the input file. 

You must specify an input file when you want to either replace or insert a 
module in the specified NCS library. Specifying an input file is optional when 
you want to create a new library. 

If you specify several input files, you must separate them with commas (,). 
The default file type for input files is NCS. 

usage summary 

Invoke the NCS Utility by entering the DCL command NCS. The NCS Utility 
exits when the specified command operations are completed. If you use the 
/LIST qualifier, you can direct output to a specified file. If you do not specify 
a file, the output is directed to SYS$OUTPUT. 
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NCS Command Qualifiers 


NCS 

COMMAND 

QUALIFIERS 


You may use one qualifier, no qualifiers, or several qualifiers with the NCS 
command, depending on the library functions you want to perform. Most 
of the qualifiers are compatible with one another and some require that you 
enter a related qualifier to do a specific task. 

Table NCS-3 lists qualifiers that require a related qualifier and qualifiers that 
are incompatible. 


Table NCS- 

-3 NCS Command Qualifier Relationships 

Qualifier 

Related Qualifiers 

Incompatible Qualifiers 

/BEFORE 2 

/LIST 


/COMPRESS 

/OUTPUT, /LIBRARY 

/CREATE, /EXTRACT 

/CREATE 1 

/LIBRARY 

/COMPRESS, /EXTRACT 

/DATA 

/COMPRESS, CREATE 

/EXTRACT, /INSERT, /REPLACE 

/DELETE 

/LIBRARY 

/CREATE, /EXTRACT 

/EXTRACT 

/LIBRARY, /MACRO, 
/OUTPUT 

/COMPRESS, /CREATE, /DELETE 

/FORMAT 3 

/MACRO 


/FULL 2 

/LIST 


/HISTORY 2 

/LIST 


/INSERT 

/LIBRARY 

/EXTRACT 

/LIBRARY 

COMPRESS, /CREATE, 
/DELETE, /EXTRACT, 
/INSERT, /LIST, /REPLACE 


/LIST 

/BEFORE, /FULL, 

/HISTORY, /LIBRARY, 
/ONLY, /SINCE, 

/EXTRACT 

/LOG 

/CREATE, /DELETE, 
/EXTRACT, /INSERT, 
/REPLACE 


/ONLY 2 

/LIST 


/OUTPUT 

/EXTRACT 

/DELETE 

/REPLACE 

/LIBRARY 

/EXTRACT 

/SINCE 2 

/LIST 



^he /CREATE, /INSERT, and /REPLACE qualifiers are compatible but /CREATE takes precedence. The related qualifiers 
for /CREATE are applicable only if you enter one or more input files. 

2 This qualifier is meaningful only when used with the /LIST qualifier. 

3 This qualifier is meaningful only when used with the /MACRO qualifier. 
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/BEFORE 


/BEFORE 

Lists only the modules inserted in the library before the specified time. 

FORMAT 

/BEFORE[= time] 

QUALIFIER 

VALUE 

time 

The time (and date, where applicable) that NCS uses as the reference cutoff 
point for accumulating the appropriate list of modules. 

DESCRIPTION 

When you use the /LIST qualifier, NCS lists all the definitions in the NCS 
library by default. However, you can use the /BEFORE qualifier with the 
/LIST qualifier to list only definitions created before a specified time (and 
date, where applicable). You may specify an absolute time or a combination 
of absolute time and delta time. For details on specifying times, see the VMS 
DCL Dictionary. 

If you use the /BEFORE qualifier without specifying the time, the output list 
includes all definitions in the library created before today. 


EXAMPLES 

Q $ NCS/LIST/BEF0RE=31-DEC-1988:13:30 

This command lists all definition modules inserted in the default NCS library 
before 1:30 p.m. on December 31, 1988. 

2 $ NCS/LIST/BEF0RE=31-DEC-1988:09:00/LIBRARY=USERDISK:[DOE]LIB.NLB 

This command lists all definition modules inserted in user DOE's local NCS 
library, LIB.NLB, before 9:00 a.m. on December 31, 1988. 
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/COMPRESS 


/COMPRESS 



Recovers disk space previously occupied by deleted definition modules. 

FORMAT 

/COMPRESS[=(option[,...])] 

QUALIFIER 

VALUE 

option 

A set of options that permits you to change the size or format of the specified 
library, overriding the values assigned to the library when it was created. See 
the listing under DESCRIPTION. 

DESCRIPTION 

The /COMPRESS qualifier effectively recers disk space previously occupied 
by modules deleted from an NCS library by creating a more efficiently 
organized output library file. If you do not explicitly specify a destination 
library, NCS creates a new compressed version of the default NCS library. 
When you compress an NCS library, you can override various NCS default 
values for the size and format of the library, using the following options: 

BLOCKS:n Specifies the number of 512-byte blocks to be allocated for 

the library. By default, NCS allocates 100 blocks for a new 
library. 

HISTORY:n Specifies the maximum number of library update history 

records that the library may maintain. By default, NCS sets 
the number at 20. 

KEYSIZE:n Changes the maximum length of definition module names. 

MODULES:n Specifies the maximum number of modules in the NCS library. 


EXAMPLES 

Q $ NCS/C0MPRESS=(BLOCKS:200)/LIBRARY=USERDISK:[DOE]LIB.NLB 

This command compresses user DOE's local NCS library and simultaneously 
allocates two hundred 512-byte blocks for it. 

2 $ NCS/COMPRESS=(KEYSIZE:35,MODULES:40)/LIBRARY=USERDISK:[DOE]LIB.NLB 

This command compresses user DOE's local NCS library and specifies a 
maximum key size of 35 bytes together with a maximum of 40 definition 
modules. 

\ 
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/CREATE 


/CREATE 

Creates an NCS library. 

FORMAT 

/CREATE[=(option[,...])] 

QUALIFIER 

VALUE 

option 

A set of options that permits you to override the system defaults for the 
size and format of the newly created NCS library. See the listing under 
DESCRIPTION. 

DESCRIPTION 

Use the /CREATE qualifier to create an NCS library. If you do not use the 
/LIBRARY qualifier to specify a new library, NCS creates a new version 
of the default NCS library. To populate the new library from an existing 
definition file, enter as the command parameter the specification for the input 
file containing the definitions. 

When you create an NCS library, you can override various NCS default 
values for the size and format of the library, using the following options: 

BLOCKS:n Specifies the number of 512-byte blocks to be allocated for 

the library. By default, NCS allocates 100 blocks for a new 
library. 

HISTORY:n Specifies the maximum number of library update history 

records that the library may maintain. By default, NCS sets 
the number to 20. 

KEYSIZE:n Changes the maximum length of definition module names. 

MODULES:n Specifies the maximum number of modules in the NCS library. 


EXAMPLES 

Q $ NCS/CREATE=(BLOCKS:200,KEYSIZE:24)/LIBRARY=DISK1:[DOE]LIB.NLB 

This command creates a file named LIB.NLB in the directory DOE, while 
simultaneously allocating the file 200 blocks and setting the maximum 
module name length at 24 characters. 

B $ NCS/CREATE=MODULES:40/LIBRARY=USERDISK:[DOE]ABC.NLB MY.NCS 

This command creates an NCS library in directory DOE named ABC.NLB. 
The command limits the library to 40 modules and populates it with 
definitions from input file MY.NCS. 
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/DATA 


/DATA 

Improves disk space efficiency. 

FORMAT 

/DATA= ( REDUCE | 
lEXPAND I 

QUALIFIER 

VALUES 

REDUCE 

Stores definitions in a data-reduced format. 

EXPAND 

Stores definitions in a data-expanded format. 

DESCRIPTION 

The /DATA qualifier gives you the option of specifying how you want 
definitions stored in the NCS library, in data-reduced format or data- 
expanded format. Note that you must specify a value, either REDUCE or 
EXPAND, with this qualifier; there is no default value. Note, too, that NCS 
does an implicit compression (recovers unused space from previously deleted 
files) on the specified library, whether you are converting the library to 
data-reduced form or to data-expanded form. 

If the specified NCS library is in standard (nonreduced) form, use the 
REDUCE option to create a new reduced version of the library. If you do 
not use the /LIBRARY qualifier to specify a library, NCS creates a new 
reduced version of the default NCS library. Note that access to libraries 
in data-reduced format is generally slower than libraries in data-expanded 
format. 

If the specified NCS library is in reduced form, use the EXPAND option to 
create a new expanded (standard) version of the library. If you do not use the 
/LIBRARY qualifier to specify a library, NCS creates a new expanded version 
of the default NCS library. Note that access to libraries in data-expanded 
(standard) format is generally faster than libraries in data-reduced format. 


EXAMPLES 

Q $ NCS/DATA=REDUCE 

This command maximizes the space efficiency of the default NCS library. 

0 $ NCS/DATA=EXPAND SYS$LIBRARY:NCS$LIBRARY 

This command reduces the access time to and space efficiency of the default 
NCS library. 
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/DELETE 


/DELETE 

Deletes one or more definition modules from the NCS library. 

FORMAT 

/DELETE=module[,...] 

QUALIFIER 

VALUE 

module 

The name of the module to be deleted. 

DESCRIPTION 

The /DELETE qualifier deletes the specified definition module or modules 
from an NCS library. If you specify several modules, separate the definition 
names with commas (,) and enclose the list in parentheses. You may use the 
standard VMS wildcard characters to specify the modules to be deleted. 

If you use this qualifier with the /LIST qualifier, NCS deletes the module 
before it lists the contents of the library. Therefore, the deleted definitions do 
not appear in the output listing. 


EXAMPLES 


U $ NCS/DELETE=CH* 

This command deletes all NCS library modules that begin with the 
letters CH. 


2 $ NCS/DELETE=(LOWER_TO_UPPER,CHANGECASE)/LIST 

This command deletes the definition CHANGECASE from the default NCS 
library and then lists the remaining definitions. 
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/EXTRACT 


/EXTRACT 

Extracts definitions from an NCS library. 

FORMAT 

/EXTRACT=module[,...] { } 

QUALIFIER 

VALUE 

module 

The name of the module to be extracted. 

DESCRIPTION 

The /EXTRACT qualifier is used to retrieve one or more definition modules 
from an NCS library. Note that you must use either the /OUTPUT 
qualifier or the /MACRO qualifier with the /EXTRACT qualifier to specify a 
destination file for the extracted definition. 

Use the /EXTRACT qualifier with the /MACRO qualifier to extract one or 
more definitions that you want to include in a MACRO-32 program file. 
When you use the /MACRO qualifier with the /EXTRACT qualifier, the 
default output file type is MAR. 

Use the /EXTRACT qualifier with the /OUTPUT qualifier to extract one or 
more definitions that you want to include in an NCS definition file. When 
you use the /OUTPUT qualifier with the /EXTRACT qualifier, the default 
output file type is NCS. 

If you want to extract several modules, separate the module names with 
commas (,) and enclose the list in parentheses. 

You may use any of the standard VMS wildcard characters to specify the 
modules to be extracted. 


EXAMPLES 

Q $ NCS/EXTRACT=CHANGECASE/MACRO=MY 

This command extracts the definition CHANGECASE from the default NCS 
library and converts it to MACRO format before storing it in the file MY.MAR. 

3 $ NCS/EXTRACT=(CHANGECASE,UPPER_TO_LOWER)/OUTPUT=MY 

This command extracts two definitions from the default NCS library and 
stores them in the definition file MY.NCS. 
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/FORMAT 


/FORMAT 

Specifies the MACRO format appropriate to your program. 

FORMAT 

/FORMAT 3 { NCS } 

QUALIFIER 

VALUES 

NCS 

MACRO-32 format for NCS routines. 

256 

MACRO-32 format for the Run-Time Library routine LIB$MOVTC. 

DESCRIPTION 

Use the /FORMAT qualifier with the /MACRO qualifier to specify the 
appropriate MACRO-32 file format. You may select one of two format 
options, either NCS (the default) or 256. If you select the NCS format, NCS 
formats the collating sequence and string conversion tables, or both, for use 
by the NCS routines. If you select the 256 format, NCS formats the collating 
sequence and string conversion tables, or both, as 256-byte tables that can be 
used by the Run-Time Library routine LIB$MOVTC. For more information, 
see the VMS Run-Time Library Routines Volume. 


EXAMPLES 

Q $ NCS/EXTRACT=UP_D0WN/MACR0=MY/F0RMAT=256 

This command extracts the definition UP-DOWN from the default NCS 
library and converts it to the 256-byte table format before including it in the 
file MY.MAR. 

S $ NCS/EXTRACT=(ABODE,XYZ)/MACRO=MY 

This command extracts two definitions from the default NCS library and 
converts them, by default, to NCS format before including them in the file 
MY.MAR. 










NCS Qualifiers 

/FULL 


/FULL 

Provides a complete listing of an NCS library. 

FORMAT 

/FULL 

PARAMETERS 

None. 

DESCRIPTION 

Use the /FULL qualifier with the /LIST qualifier to obtain an NCS library 
listing that includes the date and time each module was inserted into the 
library. The output has the following format: 

module inserted dd-mmm-yyyy hh:mm:ss 


EXAMPLE 


$ NCS/LIST/FULL 

This command lists the modules in the default NCS library, together with the 
date and time that each module was inserted into the library. 
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/HISTORY 


/HISTORY 

Provides the update history record headers for the NCS library. 

FORMAT 

/HISTORY 

PARAMETERS 

None. 

DESCRIPTION 

You use the /HISTORY qualifier with the /LIST qualifier to obtain a list 
of the update history record headers for the specified NCS library, in the 
following format: 

username operation n modules on dd-mmm-yyyy hh:mm:ss 

The operation may be a replacement, insertion, or deletion of definition 
modules. 

If you specify the /FULL qualifier with the /HISTORY and /LIST qualifiers, 
NCS lists the history record headers for each update, together with a list of 
the definition modules affected by each update. 


EXAMPLES 

Q $ NCS/LIST/HISTORY 

If you had previously deleted two definition modules from the NCS library, 
this command would produce a listing that includes the following line: 

JONES deleted 2 modules on 31-DEC-1988 16:26:36 

Q $ NCS/LIST/HISTORY/FULL 

Making the same assumptions as in the previous example, this command 
would produce a listing that includes the names of the deleted modules: 


JONES 

CHANGECASE 

UPCASE 


deleted 


2 modules on 31-DEC-1988 16:26:36 













NCS Qualifiers 

/INSERT 


/INSERT 

Adds one or more definition modules to an NCS library. 

1 

FORMAT 

/INSERT filename 

PARAMETERS 

None. 

DESCRIPTION 

Use the /INSERT qualifier to add one or more definition modules to an NCS 
library from an input file. If the input file contains more than one definition, 
NCS creates a separate entry in the library for each. 

Before NCS inserts a definition into an existing NCS library, it verifies that 
the library does not already contain a definition module having the same 
name. If NCS finds a definition module with the same name, it does not add 
the new definition module to the library, but it does provide an appropriate 
error message. 


EXAMPLES 

Q $ NCS/INSERT MY.DEFS 

This command directs NCS to insert each of the definitions from input file 
MY—DEFS.NCS into the NCS library. 

0 $ NCS/INSERT/LIST/HISTORY/FULL MY.DEFS 

This command directs NCS to insert the definitions from input file 
MY_DEFS.NCS into the NCS library; then NCS lists the history of each 
definition module in the library, including those inserted by this command. 


NCS-32 









NCS Qualifiers 

/LIBRARY 


/LIBRARY 

Specifies an alternate NCS library. The default NCS library is 
SYS$LIBRARY:NCS$LIBRARY. 

FORMAT 

/LIBRARY= filespec 

QUALIFIER 

VALUE 

filespec 

The alternate NCS library file specification. 

DESCRIPTION 

The /LIBRARY qualifier allows you to specify an NCS library other than 
the default NCS library (SYS$LIBRARY:NCS$LIBRARY). Note if you do not 
include a device and directory when you specify the alternate library, NCS 
defaults to SYS$LIBRARY. The default file type is NLB. 


EXAMPLES 

Q $ NCS/INSERT/LIBRARY=USERDISK:[DOE]MY_LIB MY.DEFS 

This command directs NCS to insert definitions from the file MY—DEFS.NCS 
into the NCS library MY—LIB.NLB. 

0 $ NCS/DELETE=UPCASE/LIBRARY=GEN_NCS 

This command directs NCS to delete the module UPCASE from the library 
file SYS$L1BRARY:GEN_NCS.NLB. 
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NCS Qualifiers 

/LIST 


/LIST 

Lists the contents of an NCS library. 

FORMAT 

/LIST[= filespec] 

/NOLIST 

QUALIFIER 

VALUE 

filespec 

The destination file specification for the list output. 

DESCRIPTION 

The /LIST qualifier allows you to obtain a listing of an NCS library. The 
optional file specification parameter allows you to store the listing in a file. 

The default file type is LIS. If you omit the file specification, NCS directs the 
listing to SYS$OUTPUT. 


You are not permitted to use wildcard characters when specifying the 
destination file. 


Note that when you use the /LIST qualifier in conjunction with qualifiers 
(such as the /DELETE qualifier) that modify the contents of the NCS library, 
NCS creates the listing after the modifications are made. For example, if you 
delete the definition module UPCASE and simultaneously request a listing, 
the listing does not include the UPCASE module. 


Listings can provide various types of information, depending on the qualifiers 
you use with /LIST. Each listing, however, contains at least the following 
information about the library: 


Directory of NCS library library-filespec on dd-mmm-yyyy hh:mm:ss 

Creation date: dd-mmm-yyyy hh:mm:ss Creator: VAX librarian Vnn-nn 

Revision date: dd-mmm-yyyy hh:mm:ss Library format: n.n 

Number of modules: nnn Max. key length: nnn 

Other entries: nnn Preallocated index blocks: nnn 

Recoverable deleted blocks: nnn Total index blocks used: nnn 

Max. update history records: nnn Update history records: nnn 


EXAMPLES 

Q $ NCS/LIST 


This command outputs a listing of the definitions in the default NCS library 
to the SYS$OUTPUT device. 

0 $ NCS/LIST=DEFLIST/FULL 

This command outputs a listing of the definitions in the default NCS library 
to a file named DEFLIST.LIS. The listing includes the date each definition was 
inserted in the NCS library. 
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NCS Qualifiers 

/LOG 

/LOG 

Determines whether or not NCS verifies library operations. 

FORMAT 

/LOG 

/NOLOG 

PARAMETERS 

None. 

DESCRIPTION 

Use the /LOG or /NOLOG qualifier to specify whether or not you want NCS 
to confirm the result of a specified operation (such as a replacement, insertion, 
or deletion). By default, NCS does not confirm operations. 


EXAMPLE 


$ NCS/DELETE=(TJL,RRR)/LOG 

This command directs NCS to delete the definitions TJL and RRR in the 
default NCS library. After deleting the definitions, NCS issues the following 
messages: 

•/.NCS-S-DELETED, module TJL deleted 
•/.NCS-S-DELETED, module RRR deleted 
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NCS Qualifiers 

/MACRO 


/MACRO 

Specifies that the extracted definition table is coded in MACRO-32. 

FORMAT 

/MACRO= filespec 

QUALIFIER 

VALUE 

filespec 

The file specification for the destination MACRO file. 

DESCRIPTION 

Use the /MACRO qualifier with the /EXTRACT qualifier if you want to 
retrieve a definition module from the NCS library, convert the definition to 
VAX MACRO format, and then output the VAX MACRO-formatted definition 
to the specified destination file. Note that each collating sequence and 
conversion function bears a global label that you can use to pass the address 
of the definition to an NCS routine. 

You must include the destination file specification with the /MACRO 
qualifier. You cannot use wildcard characters to specify the destination file. 
The default value for MACRO-32 files generated by the /MACRO qualifier is 
MAR. 

Note that you can further define a specific MACRO-32 format with the 
/FORMAT qualifier, as shown in the second example. 
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NCS Qualifiers 

/MACRO 


EXAMPLES 

Q $ NCS/EXTRACT=DOWNCASE/MACRO=MY_MACRO 

This command directs NCS to extract the definition DOWNCASE from the 
default NCS library, convert the definition to VAX MACRO format, and then 
output it to file MY_MACRO.MAR. The following example shows an NCS 
definition module converted to VAX MACRO: 

.PSECT NCS$RO_DATA NOVEC,NOWRT,RD,NOEXE,SHR,LCL,REL,CON,PIC,LONG DOWNCASE:: 

.LONG ‘X00000158,‘XOOOOOOOO.‘XOOOOOOOO,‘XOOOOOOOO 

.LONG ‘XOOOOOOOO,‘X776F6408,‘X7361636E,"X00000065 

.LONG ‘XOOOOOOOO,‘XOOOOOOOO,‘XOOOOOOOO,‘XOOOOOOOO 

.LONG ‘XOOOOOOOO,‘XOOOOOOOO,‘XOOOOOOOO,‘XOOOOOOOO 

.LONG ‘X00000005,‘X00000158,‘XOOOOOOOO,‘XOOOOOOOO 
.LONG ‘XOOOOOOOO 
.LONG ‘XOOOOOOOO 

.LONG ‘X03020100,‘X07060504,‘X0B0A0908,‘XOFOEODOC 
.LONG ‘X13121110,‘X17161514,‘X1B1A1918,‘X1F1E1D1C 


. LONG ‘X23222120,'X27262524,‘X2B2A2928,‘X2F2E2D2C 
.LONG 'X33323130,‘X37363534,‘X3B3A3938,‘X3F3E3D3C 
. LONG ‘X63626140, ‘X67666564, ‘X6B6A6968, ‘X6F6E6D6C 
.LONG ‘X73727170,‘X77767574,‘X5B7A7978.‘X5F5E5D5C 
. LONG ‘X63626160.‘X67666564,‘X6B6A6968,‘X6F6E6D6C 
.LONG ‘X73727170.‘X77767574,‘X7B7A7978,‘X7F7E7D7C 
.LONG ‘XF3F2F1F0,‘XF7F6F5F4,‘XFBFAF9F8,“XFFFEFDFC 
.END 

2 $ NCS/EXTRACT=D0WNCASE/MACR0=MY_MACR0/F0RMAT=256 

This command directs NCS to extract the DOWNCASE definition from 
the default NCS library, as in the first example. However, this command 
explicitly specifies that NCS convert the definition to the MACRO-32 format 
for use with the Run-Time Library routine LIB$MOVTC instead of the default 
NCS format. The following example illustrates the converted definition: 

.PSECT NCS$RO_DATA NOVEC,NOWRT,RD,NOEXE,SHR,LCL,REL,CON,PIC.LONG DOWNCASE:: 

. LONG ‘X03020100, ‘X07060504, ‘X0B0A0908, ‘XOFOEODOC 
.LONG ‘X13121110,‘X17161514,‘X1B1A1918,‘X1F1E1D1C 
.LONG ‘X23222120,‘X27262524,‘X2B2A2928,"X2F2E2D2C 
.LONG ‘X33323130.‘X37363534,‘X3B3A3938,‘X3F3E3D3C 
.LONG ‘X63626140,‘X67666564,‘X6B6A6968,‘X6F6E6D6C 
.LONG ‘X73727170,‘X77767574,‘X5B7A7978,‘X5F5E5D5C 
. LONG ‘X63626160, ‘X67666564, ‘X6B6A6968, ‘X6F6E6D6C 
.LONG ‘X73727170,‘X77767574.‘X7B7A7978,‘X7F7E7D7C 
.LONG "X83828180,‘X87868584,'X8B8A8988,'X8F8E8D8C 
.LONG ‘X93929190,‘X97969594,‘X9B9A9998,‘X9F9E9D9C 
.LONG ‘XA3A2A1A0,‘XA7A6A5A4,‘XABAAA9A8,‘XAFAEADAC 
.LONG ‘XB3B2B1B0,‘XB7B6B5B4,‘XBBBAB9B8,‘XBFBEBDBC 
.LONG ‘XE3E2E1E0,‘XE7E6E5E4,‘XEBEAE9E8.‘XEFEEEDEC 
.LONG ‘XF3F2F1D0.‘XF7F6F5F4,‘XFBFAF9F8,'XDFDEFDFC 
.LONG ‘XE3E2E1E0,‘XE7E6E5E4,‘XEBEAE9E8,"XEFEEEDEC 
.LONG ‘XF3F2F1F0,‘XF7F6F5F4,'XFBFAF9F8,"XFFFEFDFC 
.END 
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/ONLY 


/ONLY 

Limits the modules being listed. 

FORMAT 

/O N LY=module[,...] 

QUALIFIER 

VALUE 

module 

The module or modules to be listed. 

DESCRIPTION 

Use the /ONLY qualifier with the /LIST qualifier to specify which definition 
modules in the NCS library you want listed. If you specify more than one 
definition module, separate the module names with commas (,) and enclose 
the list in parentheses. 

You may use wildcard characters to specify the definition module(s). 


EXAMPLE 

$ NCS/LIST/ONLY=(M*,P*) 

This command directs NCS to list only the definition modules that have 
names beginning with the letter M or the letter P. 
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NCS Qualifiers 

/OUTPUT 


/OUTPUT 

Specifies the output definition file. 

FORMAT 

/OUTPUT= filespec 

QUALIFIER 

VALUE 

filespec 

The file specification for the destination file. 

DESCRIPTION 

You use the /OUTPUT qualifier with the /EXTRACT and /COMPRESS 
qualifiers to specify a destination file. 

Use the /OUTPUT qualifier with the /EXTRACT qualifier to specify a file 
to store the definitions extracted from an NCS library. The default file type 
is NCS. Note that the new definition file is not the same as the definition 
file used to originally create the definition. NCS does not store the original 
definition file, only the resultant definition. 

Use the /OUTPUT qualifier with the /COMPRESS qualifier to specify 
a destination library file for the compressed library. If you do not use 
the /OUTPUT qualifier with the /COMPRESS qualifier, NCS puts the 
compressed library in a new version of the default NCS library. The default 
file type is NLB. 


EXAMPLES 

Q $ NCS/EXTRACT=(UPCASE,DOWNCASE)/OUTPUT=USER:[DOE]NEW.DEFS.NCS 

This command directs NCS to extract two definitions (UPCASE and 
DOWNCASE) from the default NCS library and to store them in a file 
named NEW—DEF.NCS. 

0 $ NCS/COMPRESS/OUTPUT=USER:[DOE.NCS]NEW.LIB 

This command directs NCS to compress the default NCS library and to 
store the compressed version in an alternate NCS library specified as 
USER:[DOE.NCS]NEW_LIB.NLB. 
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NCS Qualifiers 

/REPLACE 


/REPLACE 

Replaces one or more definition modules in the default NCS library with 
modules from the specified input file. 

FORMAT 

/REPLACE 

i 

PARAMETERS 

None. 

DESCRIPTION 

Use the /REPLACE qualifier when you want to replace one or more library 
modules with definitions from the specified input file. If a replacement 
module in the input file does not have a corresponding module in the NCS 
library, NCS inserts, rather than replaces, the new module in the library. If 
you do not explicitly specify a qualifier for the NCS command, the default is 
the /REPLACE qualifier. 


EXAMPLE 


$ NCS MY.DEFS 

This command directs NCS to replace each definition in the default NCS 
library with a corresponding definition from the input file, MY—DEFS.NCS. 
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NCS Qualifiers 

/SINCE 


/SINCE 

Limits a library output listing to definitions inserted after the specified 
date and time. The most recent definitions are listed first, and are in 
alphabetical order. 

FORMAT 

/SINCE[=time] 

QUALIFIER 

VALUE 

time 

The time (and date, where applicable) that NCS uses as the reference point to 
begin accumulating the appropriate list of modules. 

DESCRIPTION 

Use the /SINCE qualifier with the /LIST qualifier to list only modules 
inserted into the library after the specified time (and date, where applicable). 
You can specify an absolute time or a combination of absolute and delta 
times. For details on specifying times, see the VMS DCL Dictionary. 

If you omit the /SINCE qualifier, NCS lists all the modules in the library 
unless you use a different limiting qualifier (/BEFORE or /ONLY). If you 
specify the /SINCE qualifier without a time or date, NCS lists only the 
modules inserted today. 


EXAMPLES 

Q $ NCS/LIST/SINCE=31-DEC-1988:10:00 

This command directs NCS to list only modules inserted in the default NCS 


2 $ NCS/LIST/SINCE 

library after 10 a.m. on December 31, 1988. 

This command directs NCS to list only modules inserted in the default NCS 
library today. 
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A National Character Set Definitions 


This appendix lists the contents of the default NCS library (NCS$LIBRARY). 
The library includes 13 collating sequences and 24 conversion functions. 


! Danish Collating Sequence 


Danish = CS( 

SEQUENCE = (%X00-"N", "ft", "0"-"Z", "A", "5", "A", %XDO, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= ("a" -" z" = "A"-"Z", "A"-"A" = "A", "Ai" = "A", "?" = "C", 

= ”E" = "O", "0" = "0", "O"-"0" = "U", 

»»(J*»- »»y»* — »»Y" f "a" - "a" = "A", "a"-"a" = "A "-"A", "ae" = "A", " 9 " = "C", 
= M E", "i"-"i" = "I", "n" = "ft", M 6"-"d" = "0", "6" = "Q", 

»! 0 « _ n$»»^ = "U", "u"-"y" = "Y", "(E" = "OE", "B" = "SS", 

"a" = "OE", "" < %X00) ) 

+ CS( SEQUENCE = (%X00-"A", "A"-"A", "B"-"C", "D"-"E", 

«j"-"N", "ft", "(E", "0", "6"-"6", "P"-"R", "B", 

II g II _ It 0 II M^Jll _ll£|lt lt^ll_IIY # " Z " , ,, 0*'/ "A", 11 [ M — 11 { H — £ n r 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS*("a"-"z" = "A"-"Z", "a"-"I" = "A"-"I", "n"-"y" = ) 

+ REVERSE(_NATIVE); 

ZK-6574-HC 

! Danish-to-Multinational Conversion Function 

Danis h_NRC_t o_Mu11i = CF( 

CF = _IDENTITY, MODI = ( 

= "A", 



"" = %X00)); 
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National Character Set Definitions 


! Dutch Collating Sequence 


DUTCH = CS( 

SEQUENCE = (%XOO-"N", "ft", "I", "0", "A", , %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= ("a"-"z" = ,, A ,, -"Z ,, , ,, A"- ,, A ,, = "A", "Q" = "C", = »E", 

»tJ» — »*j *» ^ f, Q ,f — m Q" = "O”, ’’O"—"O" = "u" »»^n — i»yti ''a” — "a." = M A” 

— ”A” — "yE", ,, <p n = "C", ,, e ,l -"e" = ’’E", »»^*'_»*y*» — hjh "n" = ’’f}” 

**£»* — "q" = f »O n , l »0» = M0’' ^ "u” —’’u” = »»u f ' / itytt = nyn ’'(J" = ’’OE” 

"B" = "SS", "ce" = "GE ", "" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A", "A"-"A", "B ,, - ,, C ,, / , ,, D"- ,, E”, 

"F"-"I”, "I"-"!", "J"-"N" , "ft", "GE", "0", "Q"-"6", "P"-"R", "J5", 

— "V"- "Y" , "g", "iE*' ,, 0 ,t ,, A M 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS= ("a"-"z" = "A"-"Z", "a"-"!" = »A"-"i", "n"-"y" = "ft"-"¥") ) 

+ REVERSE (_NATIVE) ; 


! EDT VT2 Conversion Function 


EDT_VT2xx = CF( 

CF = _IDENTITY, MODI = ( 


%xoo 

= 

" A 0", 

%X01 

= 

»» A^lt 

%X02 

= 

IIAgH 

%X03 

3— 

ff A C M 

%X04 

= 

" A D”, 

%X05 

= 

II Ag It 

%X06 

= 

IIApl! 

%X07 

= 

" A G", 

%X08 

= 

it a h m 

%X0A 

= 

"<LF>", 

%XOB 

= 

"<VT>", 

%XOC 

= 

"<FF>", 

%X0D 

= 

"<CR>", 

%X0E 

= 

,,A N", 

%XOF 

= 

" A 0", 

%X10 

= 

It Ap It 

%X11 

= 

" A Q", 

%X12 

= 

it aj^h 

%X13 

= 

It A g It 

%X14 

= 

It Arp It 

%X15 

= 

” A U", 

%X16 

= 

It Ay it 

%X17 

= 

It a^ii 

%X18 

= 

It AX** 

%X19 

= 

It Aytt 

%X1A 

= 

It A 2 »* 

%X1B 

= 

"<ESC>", 

%X1C 

= 

" A \ " / 

%X1D 

= 


%X1E 

= 

It A A It 

t 

%X1F 

= 

It A || 

t 

%X7F 

= 

"<DEL>", 

%X80 

= 

,, <X80>", 

%X81 

= 

"<X81>", 

%X82 

= 

"<X82>", 

%X83 

= 

"<X83>", 

%X84 

= 

"<IND>" , 

%X85 

= 

"<NEL>", 

%X86 

= 

"<SSA>" , 

%X87 

= 

"<ESA>", 
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National Character Set Definitions 


%X88 

= 

"<HTS>", 

%X89 

= 

"<HTJ>", 

%X8A 

= 

"<VTS>", 

%X8B 

= 

"<PLD>", 

%X8C 

= 

"<PLU>", 

%X8D 

= 

"<RI>", 

%X8E 

= 

"<SS2>", 

%X8F 

= 

"<SS3>", 

%X90 

= 

"<DCS>", 

%X91 

= 

"<PU1>", 

%X92 

= 

"<PU2>", 

%X93 

= 

"<STS>", 

%X94 

= 

"<CH>", 

%X95 

= 

"<MW>", 

%X96 

= 

"<SPA>", 

%X97 

= 

"<EPA>", 

%X98 

= 

"<X98>", 

%X99 

= 

"<X99>", 

%X9A 

= 

"<X9A>", 

%X9B 

= 

"<CSI>", 

%X9C 

= 

"<ST>", 

%X9D 

= 

"<OSC>", 

%X9E 

= 

"<PM>", 

%X9F 

= 

"<APC>", 

%XAO 

= 

"<XAO>", 

%XA4 

= 

"<XA4>", 

%XA6 

= 

"<XA6>", 

%XAC 

= 

"<XAC>", 

%XAD 

= 

"<XAD>", 

%XAE 

= 

"<XAE>", 

%XAF 

= 

"<XAF>", 

%XB4 

= 

"<XB4>", 

%XB8 

= 

"<XB8>", 

%XBE 

= 

"<XBE>", 

%XDO 

= 

"<XDO>", 

%XDE 

= 

"<XDE>", 

%XFO 

= 

"<XFO>", 

%XFE 

= 

"<XFE>", 

%XFF 

= 

"<XFF>”, 


"" = %X00)) ; 

ZK-6577-HC 

! English Collating Sequence 


English = CS( 

SEQUENCE = (%X00-"N", "fl", "0"-"Z", "E”, "0", "A", »["-»'», "{"-"z", %XDO, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"A" = "A", "<?" = "C", = "E", 


lljll_ »• Jll = II J II »»£)»»_»»£}*» = ”0" , = "U" , — 

»!^i»_i»jgii _ iij^i»_n^gii n^n = , »c H / = "E", ”i” — ,f i 

= "O", ” 0 " = "0", "u"-"u" = "U", ,f y” = "Y", 

"fi" = "SS", "ce" = "(E", "" < %X00) 

+ CS( SEQUENCE = (%X00-"A", "A"-"A", "Q", m D m -"E 

"P"-" i" — ”55", "CE", "O", M Q M — 

"S"-"U", "V"- "Y", "Z", "0", "A", 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS= ("a"- M z" = M A ,, -"Z ,, / "a"-"!" = "A"-"I", "n"- 
+ REVERSE( NATIVE); 


»ty»i "a"- "a” = " 

»i = t»j»»^ ’’n” s= •* 

"GE" _ 11 OE" r 

»» ng »»_»»£** 

”P"-"R", "B", 

II £ II _ II > If I* { »» _ l*£ *» 
lly II = II jjll _ H-^ll ) ) 
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National Character Set Definitions 


! Finnish Collating Sequence 

Finnish = CS( 

SEQUENCE = (%X00-"N", "ft", "0"-"Z", A", "a", "6", "A", "0", 

"{"“"d", %XD0, %XDE, %XF0, %XFE-%XFF) , 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"A" = "A", "Q" = "C", = "E", 

hJh.hJii _ HJII^ »£)"-"$" = ** 0 ", ” 0 ” = "O"-"0" = **U" = "Y" 

"a"-"a" = "A", "a"-"ae" = "A"-"jE", " 9 " = "C", "e"-"e" = "E" 

= "j", »»n*» = ”6"-"o" = "0", " 0 " = "6", "u"-"Q" = "U", 

"u»-»y» = ”Y", "(E" = "OE", "B" = "SS", "oe" = "CE", "" < %X00) ) 

+ CS ( SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C", "Q", "D"-"E", 

» , F "-" I " / "i"“"i", "j"-"N", "ft", "(E M , "0", "0"-"6", "p"-" r", »•£», 
"S"-"U", "0"-"0", "V"-"Y", "'2'", "Z", "^E", "0", "A", '*[»-*» *11 f 
%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "a"-"!" = "A"-"I", "n"-"^" = "ft"-"¥")) 

+ REVERSE (_NATIVE) ; 


! Finnish to Multinational Conversion Function 


Finnish_NRC__to_Multi = CF ( 

CF = ^IDENTITY, MODI = ( 

"[" = "A", 

"\" = »Q" f 

"]" = "A", 

ha it _ ii^Jh 

II ^ II _ lli II 
~ f 

— II « II 
~ <2 r 


11 ^ 11 
•1 | it 
ii j, 11 


= "O", 

- Hill 
~ d t 

= "li". 


"" = %X00)); 
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! French Canadian to Multinational Conversion Function 

FrCan_NRC_to_Multi = CF( 

CF = ^IDENTITY, MODI = ( 



11 { 11 _ »*0»» 

11 | 11 _ 11^11^ 

|| > *1 = "e", 

II,*, II — II011 

"" = %X00)); 


ZK-6582-HC 
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! French Collating Sequence 


French = CS( 

SEQUENCE = (%X00-"N", "ft", "0"-"Z", "R", "0", "A", "{"-"i", %XD0, 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=( ,, a ,, - ,, z ,, = "A"-"Z", "A"-"A" = "A", "Q" = "C", = ”E", 

n j it _ H ^ ii _ I* j H m Q h — m Q" = no" i*t)n — *!{) •* = M U" , = "Y", "a"-"a" = "A" 


*1 ^ II _ II »l __ ^A*' — "JE" = HQ II H^H_ llgll _ lipll II ^ II _ II 

"d"-"o" = "0 ", " 0 " = "0", "u"-"u" = "U", "f" = "Y", 
"£>" = "SS", "ce" = "(E", "" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A'\ "A"-"A", "B"-"C", "Q", "D"-"E 
•ipii.iijii^ i« X vv — v * ± •*, " J ,f - "N", "ft", "(E", "0", "6"-"&", 

"S"-"U", "0"-"0", "V"-"Y", "Z", "0", "A", 

%XD0, %XDE, %XF0 / %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z”, "a"-"i" = "n"- 

+ REVERSE (NATIVE) ; 


» = "i", "h" = "ft" 
"(E" = "OE", 

ii »»gn_ii£iii 

"P"-"R", "fi", 

ii r " _ m ii ii / ii _ ii . ii 
L t \ c t 

ii^-ii _ iijjii_try ii ) ) 


! French-to-Multinational Conversion Function 


ZK-6583-HC 


F r e nch__NRC__t o__Mu 11 i 
CF = _IDENTITY, 

II #11 - "£H, 


II 011 _ lt£H, 



= CF ( 
MODI = 


= %X00)); 


( 


ZK-6584-HC 

! German Collating Sequence 


German = CS( 

SEQUENCE = (%XOO-"N", "ft", "0"-"Z", "jE”, 
%XDE, %XFO, %XFE-%XFF), 
MODIFXCATIONS= ("a"-"z" = "A"-"Z", "A"-"A’ 

»»^h_ ii^ii iijii^ ii^H — 1|Q|| = »»o”, 

"a’l-i'ac” = "k" — "ft", "<$" — "0", "e"- 1 

"d"-"o" = "O", " 0 " = "0", "u"-"u" : 

"£>" = "SS", "ce" = "(E", "" < %X00) ) 

+ CS( SEQUENCE = (%XOO-"A", "A"-"A", "B"' 

lip II _ II j II II J II _ II J II ^ II jll _ I'N" f llj^H ^ ll(£ 
i» g ii ii ii »*{Jh_h0h^ »»yn_ i»y»» h^h ^ ii 2 ' 

%XDO, %XDE, %XFO, %XFE-%XFF), 
MODIFICATIONS= ("a"-"z" = "A"- f, Z", "a"-"! 1 

+ REVERSE (^NATIVE) ; 


"0", "A", "["-" "{"-"i", %XDO, 



"U", "f" = "Y", "(E" = "OE", 


HQ" H Qll '*D"-"E" , ,, £ H — ,f ^J" f 

, »o", "0"-"6", "P"-"R", "fi", 

, "jE", "0", "A", "{"-"i", 

= "A"-"I", "n ,, “ ,, y H = -»»y»tj) 


ZK-6585-HC 


A—5 





National Character Set Definitions 


! German-to-Multinational Conversion Function 

German_NRC_to_Multi = CF( 

CF = __IDENTITY, MODI = ( 

»@» = "§», 

[ = "A”, 

.i\.» _ »•$»*, 

•']» = " 0 ", 



"" = %X00)); 


ZK-6586-HC 

! Italian Collating Sequence 

Italian = CS( 

SEQUENCE = (%X00-"N", "ft", "JE", "0", "A", " %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= ("a"-"z" = "A"-"Z", = "A”, "Q" = "C", = »E", 

,f i »• _ »» j *» = ” i 11 / ff Q n = ’’O' 1 = m u m = »»y m "a” - "a" = ,f 

— f, A" —")E", ,, <p M = "C* 1 , "e ,, -"e" = ”E", = ?»jh M n H = " 

"6"- M o M = ”0", ,, 0 M = ”0” f "u" — M \j M = »u ,f f "y ,f = »»y m t»g;ii _ hoe" 

"B" = "SS", "ce" = "(E", "" < %X00)) 

+ CS ( SEQUENCE = (%X00-"A", "A"-"A", "B"-"C", "Q", "D"-"E", 

"F” — " I", "J"-"N", "ft", "(E", "O", "0"-"6", ”P"-"R", 

*'3»» — "u” , ’’O" — »v"-"Y", *»z f * ^ "/E" r "0" »»A»» t» ^n _»» > »i »i^t» 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS= ( "a"-"z M = "A"-"Z", "a"-"i" = »A"-"I", "n"-"y" = "ft"-"¥") ) 

+ REVERSE (_NATIVE) ; 

ZK-6587-HC 

! Italian-to-Multinational Conversion Function 

Italian_NRC_to_Multi = CF( 

CF = _IDENTITY, MODI = ( 

"#" = 

" 0 " = «§«, 

" [ " = » ° " , 

"\" = •» <? *» , 

II j ft _ l»£»! ^ 



= %X00)); 


ZK-6588-HC 


A-6 


^ > 





National Character Set Definitions 


! Multinational Collating Sequence 


Multinational = CS( 

SEQUENCE = (%XOO-"N", "ft", "0"- M Z", "£", "0", "A”, %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"A" = "A", "Q" = "C", »£"-"£" = "E", 

_ »ijI? ii^)H_ ii^ii = iiq ii "t)” —"0 M = ’’U" = I’Y't f "a”-"a" = "A", 



"B" = "SS", "ce" = "OE", "" < %X00)) 

+CS( SEQUENCE = (%XOO-"A", "A"-"A", "D”-"E", "£"-"6", 

»»p H-ii I" f ** i |» -»»± *» ^ " J"- ,, N", "ft", "(E", "O", "6"-"d", "P "- "R" , "fi", 
"S"-"U", "0"-"0", »v"-"Y", "¥", "Z", ’ME", ,, 0" / "A", ", 

%XD0, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "a"-"!" = "A"-"!", "n"-"y" = -’*1^’*) ) 

+ REVERSE(_NATIVE); 

ZK-6589-HC 

! Multinational _1 Collating Sequence 

Multinational^ = CS ( 

SEQUENCE = (%XOO-"N", "ft", "0"-"Z", "£", "0", "A", %XDO, 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS=("a"-"z" = "A"-"Z", "A"-"A" = "A", "Q" = "C", = "E", 

H Jii-hJii = H j ii H £) H _ H q H = iiq ii ’’t)" — M 0 M = "U", = M Y", "a"-"a" = "A", 

"a"-"ae" = "A"-"jE", "<?" = "C", "e"-"e" = "E", "i"- ,, i ,f = "I", "n" = "ft", 

M 6"-"o" = "0", " 0 " = "0", "u"-"u" = "U", "y" = "Y", "OE" = "OE", 

HfiH = "SS", "ce" = "(E", "" < %X00) ) ; 

ZK-6590-HC 

! Multinational_2 Collating Sequence 

Multinational^ = CS ( 

SEQUENCE = (%XOO-"A", "A"-"A", "B"-"C", "Q", "D"-"E", "£"-"6", ,f F"-"I", 
hJii.iiJii "ft", "(E", "O", "P"-"R", "JB", "S"-"U" , 

»'v"-"Y", "¥", "Z", "iE", "0", "A", %XDO, 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS® ("a"-"z" = "A"-"Z", 

"" = %X00)); 

ZK-6591-HC 

! Multinational-to-Danish Conversion Function 

Multi_to_Danish_NRC = CF( 

CF = _IDENTITY, MODI = ( 

"A" = "0”, 

"A" = 

"iE" = 

"0" = 

II ^ II — II A II ^ 

HUH _ II ^ II 

a — , 

•I a •• = »}», 

"ae" = "{", 

„0„ = "I", 

u — , 

"" = %X00)); 

ZK-6592-HC 
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! Multinational-to-Finnish Conversion Function 


Multi__to_Finnish_NRC = CF ( 

CF = _IDENTITY, MODI = ( 

"A" = 

"A" = 

"0" = M\" f 

tl^l! _ II A II ^ 

"a" = " 

"a" _ »*} i* ^ 

ii i ii _ ii > H 
e ~ t 

" 6 " = " | 
ii .‘in _ ii ii 
u — r 


= %X00)); 


ZK-6593-HC 

! Multinational-to-French-Canadian Conversion Function 


Multi__to_FrCan__NRC = CF ( 
CF = ^IDENTITY, MODI 
"a" = "@" f 
"a" = " 

"9" = 

"e" = "}", 

|'e'| = " {", 

»’e” = 

• 1^11 _ II A II 

II ^ II _ II ^ II 

u ~ r 

M U M = "I", 

II _ II ^11 

"" = %X00) ) ; 


= ( 


ZK-6594-HC 

! Multinational-to-French Conversion Function 

Multi__to__French__NRC = CF ( 

CF = ^IDENTITY, MODI = ( 


II £11 _ II ^11 



"ii" = *' ** f 

"" = %X00)); 


ZK-6595-HC 
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! Multinational-to-German Conversion Function 


Multi_to_German__NRC = CF ( 

CF = _IDENTITY, MODI = ( 

"A" = 

" 0 " = 

” 0 " = 


= »~»» f 
"a" = " 

"6" = "I”, 

"u" = 

"" = %X00) ) ; 


ZK-6596-HC 

! Multinational-to-Italian Conversion Function 


Multi_to_Italian_NRC = CF ( 

CF = ^IDENTITY, MODI = ( 

»» O It _ It £ II 

1*3.’. = " {", 

t« — ** _ ii \ ii 

V “ \ / 

= 

>" = „],i f 

ii it _ »i ^ ii ^ 
ii 6 ii = iijii^ 


' e' 
"e' 


,,,, = %X00)) ; 


ZK-6597-HC 

! Multinational-to-Lowercase Conversion Function 


Multi_to_Lower = CF( 

CF = _IDENTITY, MODI = ( 
= ,, a ,, “ ,, z M , 

ii^ii_n^n = it ^ ii _ ii 
»» »• _ ii’^h — "n 1 * — f 

"" = %X00)); 


ZK-6598-HC 
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! Multinational-to-No-Diacriticals Conversion Function 

Multi_to_NoDiacriticals = CF( 

CF = ^IDENTITY, MODI = ( 

tlj^lt _ ft j^ll = M J\ M 
IIQIt IIQII 

_»lg»» = tig It 

— *»£»» = ttjff 

»*f!} •»_»»£)" — ,, N ,, - ,, 0 ,, , 

= "O", 

„ 0 „ = " 0 ", 

= "U", 



llytl _ n y t* ^ 

"A" = "AE", 
"GE" = f, 0E ", 
”J5" = "ss", 
"a" = "ae", 
"ce" = "oe", 

= %X00)); 


ZK-6599-HC 

! Multinational-to-Norwegian Conversion Function 

Multi__to__Norwegian__NRC = CF ( 

CF = _IDENTITY, MODI = ( 

"A" = 

"A" = 

"JR" = " 

" 0 " = 

H 0 II — ft A It 

II Si It _ II ^ It 

a — , 

= it} it ^ 

"a" = 

” 0 " = "|", 

tt^ti _ 11^,11^ 

"" « %X00) ) ; 

ZK-6600-HC 


/ 
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! Multinational-to-Swedish Conversion Function 


Multi_to_Swedish_NRC = CF( 

CF = _IDENTITY, MODI = ( 

"A" = 

"A" = 

"6” = 

"O" = 

II 0 f» _ II A II ^ 

"a" = 

,'a. ’• = 



ii,*tn _ ** ?* 

u — f 

"" = %X00)); 


ZK-6601-HC 

! Multinational-to-Swiss Conversion Function 

Multi_to__Swiss_NRC = CF ( 

CF = IDENTITY, MODI = ( 



"u" = 

II.Q II _ 110 II — II } ** _ »» ** f 

"" = %X00)); 

ZK-6602-HC 

! Multinational-to-United-Kingdom Conversion Function 

Multi_to_Uk_NRC = CF ( 

CF = ^IDENTITY, MODI = ( 

ll£ll _ 

"" = %X00) ) ; 

ZK-6603-HC 

! Multinational-to-Uppercase Conversion Function 

Multi__to__Upper = CF ( 

CF = ^IDENTITY, MODI = ( 

ii a ii_ii z n — , 

H ^ II _ II II — "A M “ ”1 *' / 

"(E" = "OE", 

**B i* = "SS", 

"" = %X00)); 

ZK-6604-HC 
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! Norwegian Collating Sequence 

Norwegian = CS( 

SEQUENCE = (%X00-"N", "ft", "0"-"Z", "A", %XD0, 

%XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS= ( ,, a ,, -"z" = "A"-"Z", "A"-"A" = "A", "Q’ f = "C M , = "E" 

"i"—"I" = "Q" — = ”o M , ,, 0" = ’’O*’ — M 0 M = ”U ,? »iy»i__ ify»i 

"a"-"a" = "A", "a"-"®" = "A m -"jE", "g" = "c M »»£»*_»»g»i - iipn 

"i"-"!" _ M I .t / I.^M - "ft", "6"-"6" = ”0", "6" = "0", "0’' = " 0 ", 

"u 11 - M 0 ” = "U", "u M —= "Y", "A" = n AE”, "(E" = "OE" ’’B" = "SS" 

"a" = "A", "ce" = "GE", "" < %X00)) 

+ CS( SEQUENCE = (%XOO-"A", ,, A"- ,, A", "B"-"C", "Q", "D"-"E", 

"F»-"I", ” 1 ” ± r "J"-"N", "ft", "(E", "0", "6"-"6", "p"-"R», "B", 

"S"-"U", "0"-"0", "V"-"Y", »Z", "/E", " 0 ", "A", n { M — ii. ii 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS= ("a"-"z" = "A"-"Z", **a. ,f — !L** = M A"- M i", "n"-"y" = "ft"_'»¥") ) 

+ REVERSE (_NAT IVE) ; 

ZK-6605-HC 

! Norwegian-to-Multinational Conversion Function 

Norwegian_NRC_to_Multi = CF( 

CF = ^IDENTITY, MODI = ( 

"@" = "A", 

"[" = "jE", 

•i\n = ii 0 n^ 

||] |. = m A", 

II A || _ II^Jll 



= %X00)); 


ZK-6606-HC 

! Portuguese Collating Sequence 


Portuguese = CS( 

SEQUENCE = (%XOO-"N", "ft", "0 ,, -"Z H , "£", "0", "A", "{"-'V*, %XDO 

%XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS= ("a ,, -"z" = "A"-"Z", "A"-"A" = "A”, "Q» = "C", = »e" 

iiJii.iiJh __ iijn^ "Q"-"Q" =- "0"-"0" = "u" »*¥" = i» y” "a"-"a" = " 

"a"-"ae" = "A"-"£", "g" = "C”, "e"-"e" = "E", = »»j»» h^h = h 


"6"-"6" = 

ii 

0”, "0 

II _ 11011^ 

II £11 _ II 

U" = 

i»U" , »»y»» = iiyii 

"GE" = 

"OE", 

"B" = "SS" 

t 

"ce" = 

"GE", "" 

< %X00) ) 




+ CS( SEQUENCE = 


(%X00- 

»»A" f "A H - 

"A", 

iign _ ll 

C*» / »»"D"- "E 

ii i»g»i_ 


iipii_nj*» ii 

i 

»| — *» f i» 

x t 

" j*i- "N" , 

"S", 

"(E", 

"0”, "0"-"d", 

*'p ” _ "p M 

, "fi”, 

"S"-"U" / H 

0 

"-"0", 

•l Y" _ liyn 

"it". 

"Z", 

"jE", "0”, "A 1 ', 

'• ^ ii _ ii ^ 


%XDO, %XDE 

/ 

%XFO, 

%XFE-%XFF) , 




MODIFICATIONS=(” 

a 

"-" Z " : 

— n^ii _ ”2'* 

It A ll 
t a 

_ *i ^»» 

= "A"-"i", "fi"- 

»y" — •• 

ft"-"¥")) 


+ REVERSE (_NATIVE) ; 


A" 

S" 


II 


ZK-6607-HC 
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! Spanish Collating Sequence 

Spanish = CS( 

SEQUENCE = (%X00-"B", "Q", "CH M , "D"-"L", ’’LL", "M"-"N", "ft", »0"-"Z", "£", 

"0", "A", "{"-"i", %XD0, %XDE, %XF0, %XFE-%XFF), 

MODIFICATIONS=("a"-"b" = "A"-"B", "d"-’’k" = "D"-"K", "m"-"z" = "M"-’’Z", 

— M^tl _ 11^1! —— llgll lljll — II J II — II J II ,, Q M — f, Q M = M 0" 

»i^)»» — '»tJ|* = M U" = H y m "a"-"a" = "a ", M a" — "^j" = "A"“"Q", 

"e"-"e" = "E", "i"-"i" = "I", "n" = "ft", ”6"-"o" = "0", " 0 " = "0", 

"u"-"u" = "U", "y" = "Y", "C" = "Q", "Ch" = "CH", "LI" = "LL", 

"c" = "Q", "cH" = "CH", "ch" = "CH", "1" = "L", "1L" = "LL", 

"11" = "LL", ”(E" = "OE", "fi" = "SS", "ce" = ”(E", < %X00) ) 

+ CS( SEQUENCE = (%X00-"A", "A"-"A", "B"-"C", "Q", "D’’-"E", 

•»p”-»»I" f ••l»i_nt»» / "J"-"N", "ft", ”(E", "0", "6"-"d", "P"R", "B", 

"S"_"u" "O" — "!)" »»v” — "Y" "Z", "iE", "0", "A", n [ M — ^ 

%XDO, %XDE, %XFO, %XFE-%XFF), 

MODIFICATIONS= ("a"-"z" = "A"-"Z", ) 

+ REVERSE(_NATIVE); 

ZK- 66 O 8 -HC 

! Swedish-to-Multinational Conversion Function 

Swedish_NRC_to_Multi = CF( 

CF = _IDENTITY, MODI = ( 

"[" = "A", 

**\i» = "5", 

••]" = "A", 

II A II _ II II ^ 

II * II — IIA II 

— e / 

»* {** = "a", 

II I ii _ I* gn f 

*•} ** = "a", 

H _ 11 u", 

’”’ = %X00) ) ; 

ZK-6609-HC 

! Swiss-to-Multinational Conversion Function 

Swiss_NRC__to__Multi = CF ( 

CF = IDENTITY, MODI = ( 



»• }’* — **~i* = M u"—"0" 
"" = %X00)); 


ZK-6610-HC 

! United-Kingdom-to-Multinational Conversion Function 


U k_NRC_t o_Mu11i = CF( 

CF = _IDENTITY, MODI = ( 

= %X00) ) ; 


ZK-6611-HC 
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MACRO-32 file format, from NCS library 
See /FORMAT qualifier 
MACRO-32 output, from NCS library 
See /MACRO qualifier 
/MACRO qualifier *NCS-36 
Maximum number of history records 

NCS library, specifying • NCS-24, NCS-25 
MODIFICATIONS keyword 

using in collating sequence expression*NCS-14 
using in conversion function expression* 

NCS-16 

MODIFICATIONS keyword clause*NCS-17 
Modules 

replacing in the default NCS library • NCS-21 
Multinational Character Set*NCS-3 
Multiple definition modules 

specifying with /DELETE qualifier*NCS-27, 
NCS-32 

specifying with /EXTRACT qualifier *NCS-28 
specifying with /ONLY qualifier*NCS-38 
Multiple input files 
specifying • NCS-21 
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National Character Set Utility 
See NCS Utility 
NCS command 

specifying input files for*NCS-21 
NCS keyword 

for /FORMAT qualifier*NCS-29 


NCS library 

creating* NCS-25 

See also /CREATE qualifier 
deleting definition modules from*NCS-27 
extracting definition modules from • NCS-28 
generating MACRO-32 output from*NCS-36 
generating NCS definition files from*NCS-39 
inserting definition modules*NCS-32 
obtaining listing of*NCS-34 
replacing definition modules • NCS-40 
specifying an alternate *NCS-33 
specifying history records*NCS-24, NCS-25 
specifying MACRO-32 output format*NCS-29 
specifying maximum length of definition module 
names* NCS-24, NCS-25 
specifying maximum number of modules* 
NCS-24, NCS-25 
specifying size*NCS-24, NCS-25 
verifying operations*NCS-35 
with data-expanded format • NCS-26 
with data-reduced format • NCS-26 
NCS Utility • NCS-3 
DCL interface 

default function • NCS-3 
library functions • NCS-3 
directing output*NCS-21 
exiting • NCS-21 
functions* NCS-3 
implementation • NCS-3 
Number of modules 

in NCS library, specifying • NCS-24, NCS-25 
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/ONLY qualifier*NCS-38 
/OUTPUT qualifier *NCS-39 
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Pad character 

in collating sequence*NCS-10 
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REDUCE keyword 

for /DATA qualifier*NCS-26 
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/REPLACE qualifier »NCS-40 
Required values 

for /DATA qualifier*NCS-26 




Verification of NCS library operations 
See /LOG qualifier 


SEQUENCE keyword 
description • NCS-13 
/SINCE qualifier *NCS-41 
Size 

NCS library, specifying *NCS-24, NCS-25 
String 

how denoted • NCS-7 

limit on numeric representation*NCS-7 

ranges used in collating sequence*NCS-18 
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Wildcard characters 

use ofNCS-27, NCS-28, NCS-38 
use restriction • NCS-34, NCS-36 
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